clean-tag

clean-tag

Removes unwanted style props from the underlying HTML element when using styled-components.

If you see React warnings when using styled-components, this can help.

npm i clean-tag

Styled-components has a long-standing issue related to how it whitelists HTML attributes when parsing props. The whitelist method will cause certain React props to be passed to the underlying HTML element if they happen to be a valid (often legacy) HTML attribute, such as color or fontSize.

import styled from 'styled-components'
import { space, width, color } from 'styled-system'
import tag from 'clean-tag'

const Box = styled(tag)`
  ${space}
  ${width}
  ${color}
`

export default Box

// custom HTML element on component definition
const Heading = styled(tag.h2)`
  ${fontSize}
  ${fontWeight}
  ${lineHeight}
  ${space}
  ${color}
`

is prop

Changes the underlying HTML element per component instance.

<Heading is='h1' />

blacklist prop

Provide a custom blacklist of prop names.

The default blacklist is based on Styled System's propType definitions.

<Heading
  blacklist={[
    'fontSize',
    'color'
  ]}
/>

innerRef prop

Pass the innerRef prop to the styled-component.

<Heading
  innerRef={ref => this.heading = ref}
/>

MIT License